home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / standard / zwritemask.z / zwritemask
Text File  |  1998-10-20  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4. zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk((((3333GGGG))))                                                  zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk - specifies a write mask for the z-buffer of the current
  10.      framebuffer
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      vvvvooooiiiidddd zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk((((mmmmaaaasssskkkk))))
  14.      uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg mmmmaaaasssskkkk;;;;
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _m_a_s_k   expects a mask indicating which z-buffer bitplanes are read only
  18.             and which can be written to.  Z-buffer bitplanes that correspond
  19.             to zeros in the mask are read only.  Z-buffer bitplanes that
  20.             correspond to ones in the mask can be written.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk specifies a mask used to control which z-buffer bitplanes are
  24.      written, and which are read only.  A separate mask is maintained by each
  25.      of the framebuffers, normal, popup, overlay, and underlay.  The mask
  26.      affects both writes to the z-buffer that are the result of z-buffer pixel
  27.      operation, and writes resulting from zzzzcccclllleeeeaaaarrrr operation.
  28.  
  29.      zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk is ignored while drawing directly to the z-buffer, as when
  30.      zzzzddddrrrraaaawwww is TRUE. In this case the current writemask applies to the z-buffer
  31.      as well as to the color bitplanes.
  32.  
  33.      zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk is initialized when a window is created, and when ggggccccoooonnnnffffiiiigggg is
  34.      called, to enable all z-buffer bitplanes.
  35.  
  36. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  37.      gconfig, wmpack, writemask, zbuffer, zdraw
  38.  
  39. NNNNOOOOTTTTEEEESSSS
  40.      Currently z-buffer operation is supported only in the normal framebuffer.
  41.      To insure compatibility with future releases of the GL, make calls to
  42.      zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk only while draw mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.
  43.  
  44. BBBBUUUUGGGGSSSS
  45.      This subroutine does not function on IRIS-4D B or G models.
  46.  
  47.      IRIS-4D GT and GTX models, RealityEngine models, and the Personal Iris,
  48.      currently support a subset of z write mask functionality.  Specifically,
  49.      zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk either enables or disables the writing of all z-buffer
  50.      bitplanes. The mask passed to zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk will disable z-buffer writes if
  51.      it is zero; otherwise all z-buffer bitplanes are written.  To assure
  52.      upward compatibility with the IRIS-4D VGX and other future models, call
  53.      zzzzwwwwrrrriiiitttteeeemmmmaaaasssskkkk with _m_a_s_k equal to either 0 or 0xFFFFFFFF when all-or-nothing
  54.      update is desired.
  55.  
  56.      On Impact and Infinite Reality individual z bitplanes are not maskable.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.